home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / csxtm105.zip / CSXTM.DOC < prev    next >
Text File  |  1992-06-01  |  6KB  |  117 lines
  1.         (****************************************************)
  2.         (* CSXTIME Ver 1.0    Written by Gary Bouchard      *)
  3.         (* SysOp - The Computer Store BBS                   *)
  4.         (* St. Augustine, Florida (904)794-0063             *)
  5.         (* Copyright(c) 1992....All Rights Reserved         *)
  6.         (* Released May 29, 1992    Modified                *)
  7.         (****************************************************)
  8.  
  9.                            Description
  10.  
  11. CSXTIME is a small PCBoard utility written for PCBoard 14.5a or greater
  12. that will allow your users to find out how long it would take to
  13. transfer a file from your BBS. The program was written to operate as a
  14. seamless menu option type utility, which will very quickly tell the user
  15. the desired information without trying to use the "D"ownload function
  16. and aborting for his/her answer.
  17.  
  18.                               Setup
  19.  
  20. You need to copy at very least the CSXTIM.EXE program and the associated
  21. configuration file CSXTIM.CNF to a directory accessible by PCBoard. If
  22. you have room I suggest the \pcb home directory.
  23.  
  24. Copy XT.HLP to your PCB\HELP directory, and rename it minus the ".HLP"
  25. extension.
  26.  
  27. Edit your CSXTIM.CNF file to reflect the desired information. There are
  28. 3 pieces of information that go into the config file.
  29.  
  30. Line 1) INTERRUPT.  ; This is used in all ProKit type Doors.
  31. Line 2) ZIP         ; This is the default file extension to use.
  32. Line 3) User Prompt ; Definable user prompt with a max of 60 chars in
  33.                       length. You may also use @X## Color macros to
  34.                       define this prompt. See the sample config file
  35.                       enclosed.
  36.  
  37. You must then go into PCBoard setup, select option "J" - Main Board
  38. configuration. Add an entry into the PCBoard Doors.lst file to allow
  39. proper operation of the program. On my BBS it looks like this;
  40.  
  41. ╔═════════════════════════════════════════════════════════════════════════════
  42. ║                               Edit DOORS File
  43. ║
  44. ║                                     USER DOOR
  45. ║    Filename    Password   Sec Login SYS  SYS  Shell    Path to DOOR Files
  46. ║   ══════════ ════════════ ═══ ═════ ════ ════ ═════ ════════════════════════
  47. ║  1) XT                     30   N    N    N     Y   C:\PCB\
  48. ║
  49. ║
  50. ║
  51. ║                       Press F2 to edit the DOOR file
  52. ║
  53. ║  ESC=Exit   Alt-R=Repeat a Line   Alt-I=Insert a Line   Alt-D=Delete a Line
  54. ╚══ 09:51:25 ═══ 05-29-92 ══════ F1 ═ help ════ caps: OFF  num: ON   ins: OFF
  55.  
  56. I created a PCBoard type batch file (no extension) called "XT". Inside
  57. this PCBoard bat file I have the following;
  58.  
  59. @echo off
  60. c:\pcb\xtime.exe c:\pcb\xtime.cnf c:\pcb
  61.  
  62. Notice that I placed path names on both the executable program AND the
  63. config file. PCBoard is much more efficient in running programs that are
  64. executed in this manner.
  65.  
  66. I then added the "XT" command to my PCBoard menu, and you can also add
  67. help text to it, following the PCBoard format.
  68.  
  69.                             OPERATION
  70.  
  71. Operation is simply this; At the PCBoard command prompt, whether at the
  72. Main Board or in a conference, the user would type "XT <filename>" and
  73. press <enter>. If the user types the "XT" command without any filename,
  74. it will respond with your user defined prompt, asking for a file name.
  75. If the user responds with an <enter> with no file name, it simply
  76. returns to the PCBoard command prompt. In other words, the user never
  77. knows that he left PCBoard. Once the program begins, it will go through
  78. all of the DL paths you have specified in your PCBoard setup, looking
  79. for this file. Once found, the program will display the file size,
  80. estimated transfer time, and then current connect speed. Pressing enter
  81. from this point returns you back to the PCBoard command prompt.
  82.          
  83.                              DETAILS
  84.  
  85. CSXTIME is a copyrighted program. It is not Public Domain Software. I
  86. retain the rights to the source code for CSXTIME, and any modification,
  87. de compilation, or otherwise general hacking of CSXTIME is prohibited.
  88.  
  89. I cannot be held responsible for any damages caused by the use of this
  90. program. All know bugs have been squashed, but as with any new program,
  91. it has not been tested in every possible environment
  92.  
  93. There is no charge for CSXTIME. The program is being offered as
  94. FREEWARE to the thousands of PCBoard SysOps who are partially
  95. responsible for the BBS revolution. I am not a professional programmer, and
  96. I have a full time job (fortunately!). I program for a hobby, and write
  97. utilities for my personal PCBoard BBS. I share my utilities with other
  98. PCBoard SysOps, because I know of the hardships that can sometimes come
  99. about from running a BBS, including the many dollars put in to each
  100. system for the software and hardware needed to run a good system. SysOps
  101. like myself cannot afford to pay for all of the utilities authored by
  102. all of these people which make the job of running a BBS some much
  103. easier. There are many quality programs out there, that are well worth
  104. the small amount of money that is requested, but it all adds up, and
  105. fast! That is why I write FREEWARE programs..
  106.  
  107. As you might have noticed, I am not a good writer when it comes to
  108. documentation. If you do not understand something relating to this
  109. program please feel free to call my free access BBS at the phone number
  110. written at the top of this document. I will try to clarify whatever
  111. problem your having.
  112.  
  113.                            Acknowledgements
  114.  
  115. Portions of this program have been written with the aid of routines
  116. written by Samuel H. Smith of the ToolShop BBS (Prodoor).
  117.